home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 3 / ct-rom iiib.zip / ct-rom iiib / WINDOWS / GRAFISCH / FRACXTR5 / PARTOBAT.TXT < prev    next >
Text File  |  1993-02-26  |  7KB  |  182 lines
  1.  
  2.  PARtoBAT (written by Michael Peters 100041,247)        Version 3.0 / March 93
  3.  
  4.  PARtoBAT is a tool that generates batch files from FractInt PAR files.
  5.  
  6.  ┌────────────────┐
  7.  │ Change history │
  8.  └────────────────┘
  9.  
  10.    2.1 introduced code names for GIF files
  11.        (Suggestion by Jon Horner)
  12.    2.2 checks Fractint errorlevel, plus: If the video mode is not specified,
  13.        it can now be entered on the batch command line.
  14.        (Suggestions by Timothy Wegner)
  15.    3.0 this version features some more ideas by Tim (and some of my own).
  16.        Batches now quits with errorlevel 2 (for Fractint v. 18 and above,
  17.          has no effect if earlier versions are used)
  18.        PAR files shown in alphabetical order
  19.        Wildcard support, creates Newpars.Bat, reads SSTOOLS.INI
  20.        Indirect @ files can be read (suggestion by Nelson Hinman)
  21.  
  22.  ┌────────┐
  23.  │ Syntax │
  24.  └────────┘
  25.  
  26.   PARtoBAT [o[+|-]] [PAR files] [VIDEO=<mode>] [CODENAME=xxxxx[nnn]] [parms]
  27.  
  28.   where
  29.     [-o[+|-]]             = Overwrite or don't overwrite existing batch files.
  30.                             Enter -o or -o+ to enable overwrite,
  31.                             -o- to disable overwrite.
  32.     [PAR files]           = a Fractint .PAR filename (wildcards allowed).
  33.                             An indirect filename (a file containing PAR
  34.                             filenames, see below) can be entered instead.
  35.     [VIDEO=mode]          = specify a Fractint video mode here
  36.     [CODENAME=xxxxx[nnn]] = a codename for GIF files (see below)
  37.     [parms]               = any number of other Fractint startup parameters
  38.  
  39.   e.g. PARtoBAT -o+ M*.PAR VIDEO=SF7 CODENAME=WOW027 SOUND=ON HERTZ=440
  40.  
  41.  
  42.   PARtoBAT started without parms will prompt for the corresponding values
  43.     unless they are specified in SSTOOLS.INI (see below).
  44.  
  45.  
  46.   NOTE: In PARtoBAT version 1 and 2, the video mode could be entered without
  47.         a leading 'VIDEO='. This is no longer possible - you now have to add
  48.         the 'VIDEO=', e.g. VIDEO=SF7.
  49.  
  50.  ┌─────────────────────┐
  51.  │ SSTOOLS.INI support │
  52.  └─────────────────────┘
  53.  
  54.   PARtoBAT default values can be put into the Fractint file SSTOOLS.INI
  55.   (a description for SSTOOLS.INI is contained in Fractint). You need to
  56.   specify a [PARtoBAT] section in SSTOOLS.INI. Other sections will be
  57.   ignored by PARtoBAT.
  58.  
  59.   One of the following parameter values can be put into SSTOOLS.INI:
  60.  
  61.      BATCHOVERWRITE=yes|no  = default value for batch overwrite
  62.      VIDEO=mode             = specify a Fractint video mode here
  63.      CODENAME=xxxxx[nnn]    = a codename for GIF files (see below)
  64.  
  65.   and any other default parameters for Fractint, like
  66.      SOUND=ON
  67.      HERTZ=440
  68.   etc.
  69.  
  70.  
  71.   If overwrite, videomode, or codename are specified in the command line,
  72.   this will override the defaults from SSTOOLS.INI.
  73.  
  74.   If overwrite is not specified in SSTOOLS.INI or in the command line, and
  75.   batch files for the specified PAR files are found, PARtoBAT will ask you
  76.   if they can be overwritten.
  77.  
  78.   If the videomode is neither specified in SSTOOLS.INI nor in the command
  79.   line, PARtoBAT will ask for it.
  80.  
  81.   If no codename was specified in SSTOOLS.INI or in the command line,
  82.   PARtoBAT will ask for one *only when it is called without parameters*
  83.   in the command line, that is, if you enter PARtoBAT on the C> prompt.
  84.  
  85.  
  86.  ┌──────────┐
  87.  │ Filename │
  88.  └──────────┘
  89.  
  90.   You have to specify the name of the PAR file (wildcards can be used).
  91.   The PAR files must be located in the current directory.
  92.   Instead of a PAR filename, you can also enter an indirect filename,
  93.   that is, the name of a file that contains PAR filenames (one per line).
  94.   If you do this, use a @ to indicate the indirect filename, e.g.
  95.  
  96.     PARtoBAT @Indirect.Txt
  97.  
  98.   instead of
  99.  
  100.     PARtoBAT X*.PAR
  101.  
  102.  
  103.  ┌────────────────────────────────┐
  104.  │ Overwrite existing batch files │
  105.  └────────────────────────────────┘
  106.  
  107.   If no overwrite option was entered on the command line or in SSTOOLS.INI
  108.   and batch files for the PAR files are found, PARtoBAT will ask you if
  109.   the batch files can be overwritten.
  110.  
  111.  
  112.  ┌────────────┐
  113.  │ Video mode │
  114.  └────────────┘
  115.  
  116.   Enter a Fractint video mode (PARtoBAT does not check if the video mode
  117.   you specify is valid) in SSTOOLS.INI or on the command line (in the
  118.   format VIDEO=<mode> ), or on the PARtoBAT prompt.
  119.  
  120.   The video mode can be left empty. In this case, it will be included
  121.   in the batch file as a %1 batch parameter: You have to specify the video
  122.   mode as a command line parameter when you run the batchfile.
  123.  
  124.  
  125.  ┌─────────────────────────────┐
  126.  │ Optional startup parameters │
  127.  └─────────────────────────────┘
  128.  
  129.   Enter any number of optional startup parameters for Fractint (e.g.
  130.   SOUND=OFF SAVETIME=60 etc.) in SSTOOLS.INI, on the command line,
  131.   or on the PARtoBAT prompt. Anything not recognized by PARtoBAT, e.g.
  132.  
  133.     BLAH=BLAH
  134.     ABCDEFGHIJKLM
  135.  
  136.   will be transferred to the batch command and to Fractint.
  137.  
  138.  
  139.  ┌───────────────┐
  140.  │ GIF code name │
  141.  └───────────────┘
  142.  
  143.   Each fractal in the PAR file has been given a name already. The
  144.   corresponding GIF file will be named like in the PAR file. Alternatively
  145.   you may specify a code name for the GIF files in this file. The new GIF
  146.   files will be given this code name plus a 3-digit number (Code name EXAMP
  147.   will produce the GIF names EXAMP001.GIF, EXAMP002.GIF etc.). If the
  148.   specified code name already contains a 3-digit number, the new GIF files
  149.   will start counting from there.
  150.  
  151.   If GIF files with the code name exist, the numbers will automatically
  152.   increment from there.
  153.  
  154.   Maximum length for the code name (without trailing digits) is 5
  155.   characters.
  156.  
  157.   If no code name is specified, the default names are used for the GIF
  158.   files.
  159.  
  160.  
  161.  ┌─────────────────┐
  162.  │ The batch files │
  163.  └─────────────────┘
  164.  
  165.   Each batch line containing a Fractint call is followed by an errorlevel
  166.   check (errorlevel 2). If Fractint is aborted during the batch, the batch
  167.   execution will stop.
  168.  
  169.   For each GIF file that already exists, the corresponding command line
  170.   will be disabled by a 'rem'. This means that you can interrupt a PARtoBAT
  171.   generated batch file anytime, and start it again later. Before you start
  172.   it again, just run PARtoBAT (with overwrite enabled) to recreate the
  173.   batch file. While creating the batch file, the lines that refer to GIF
  174.   files which already exist will be disabled.
  175.  
  176.   If you use wildcards when specifying the PAR files, and more than one
  177.   batch file is created by PARtoBAT, an additional batch file will be
  178.   written (NEWPARS.BAT). This batch can be run to execute all new batch
  179.   files at once.
  180.  
  181.  
  182.